home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3 / complib / clascl.z / clascl
Text File  |  1998-10-30  |  3KB  |  133 lines
  1.  
  2.  
  3.  
  4. CCCCLLLLAAAASSSSCCCCLLLL((((3333FFFF))))                                                          CCCCLLLLAAAASSSSCCCCLLLL((((3333FFFF))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      CLASCL - multiplie the M by N complex matrix A by the real scalar
  10.      CTO/CFROM
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      SUBROUTINE CLASCL( TYPE, KL, KU, CFROM, CTO, M, N, A, LDA, INFO )
  14.  
  15.          CHARACTER      TYPE
  16.  
  17.          INTEGER        INFO, KL, KU, LDA, M, N
  18.  
  19.          REAL           CFROM, CTO
  20.  
  21.          COMPLEX        A( LDA, * )
  22.  
  23. PPPPUUUURRRRPPPPOOOOSSSSEEEE
  24.      CLASCL multiplies the M by N complex matrix A by the real scalar
  25.      CTO/CFROM.  This is done without over/underflow as long as the final
  26.      result CTO*A(I,J)/CFROM does not over/underflow. TYPE specifies that A
  27.      may be full, upper triangular, lower triangular, upper Hessenberg, or
  28.      banded.
  29.  
  30.  
  31. AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  32.      TYPE    (input) CHARACTER*1
  33.              TYPE indices the storage type of the input matrix.  = 'G':  A is
  34.              a full matrix.
  35.              = 'L':  A is a lower triangular matrix.
  36.              = 'U':  A is an upper triangular matrix.
  37.              = 'H':  A is an upper Hessenberg matrix.
  38.              = 'B':  A is a symmetric band matrix with lower bandwidth KL and
  39.              upper bandwidth KU and with the only the lower half stored.  =
  40.              'Q':  A is a symmetric band matrix with lower bandwidth KL and
  41.              upper bandwidth KU and with the only the upper half stored.  =
  42.              'Z':  A is a band matrix with lower bandwidth KL and upper
  43.              bandwidth KU.
  44.  
  45.      KL      (input) INTEGER
  46.              The lower bandwidth of A.  Referenced only if TYPE = 'B',
  47.  
  48.      KU      (input) INTEGER
  49.              The upper bandwidth of A.  Referenced only if TYPE = 'B',
  50.  
  51.      CFROM   (input) REAL
  52.              CTO     (input) REAL The matrix A is multiplied by CTO/CFROM.
  53.              A(I,J) is computed without over/underflow if the final result
  54.              CTO*A(I,J)/CFROM can be represented without over/underflow.
  55.              CFROM must be nonzero.
  56.  
  57.      M       (input) INTEGER
  58.              The number of rows of the matrix A.  M >= 0.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. CCCCLLLLAAAASSSSCCCCLLLL((((3333FFFF))))                                                          CCCCLLLLAAAASSSSCCCCLLLL((((3333FFFF))))
  71.  
  72.  
  73.  
  74.      N       (input) INTEGER
  75.              The number of columns of the matrix A.  N >= 0.
  76.  
  77.      A       (input/output) COMPLEX array, dimension (LDA,M)
  78.              The matrix to be multiplied by CTO/CFROM.  See TYPE for the
  79.              storage type.
  80.  
  81.      LDA     (input) INTEGER
  82.              The leading dimension of the array A.  LDA >= max(1,M).
  83.  
  84.      INFO    (output) INTEGER
  85.              0  - successful exit <0 - if INFO = -i, the i-th argument had an
  86.              illegal value.
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.